Update from code changes: document static export URLs - #6875
Conversation
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
|
Update from code changes updated this PR. Updated wording, translation phrasing, heading consistency, and Chinese SEO metadata Source PRs
|
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
Summary
Document the
.htmlURLs emitted by static export bundles so they work on hosts without extensionless rewrites.Changes
.htmldestinations for built-in internal navigation, including version and language switchers, search results, cards, assistant citations, and API playground links.Context
This documents the static export URL changes in mintlify/mint#9840 and the follow-up imperative navigation fix in mintlify/mint#9842.
Note
Low Risk
Documentation-only changes to static export overview pages; no application or API code.
Overview
Documents how static export bundles expose pages as explicit
.htmlURLs (e.g./guides/getting-started.html,/index.html) so self-hosters know what to expect when uploading to S3 or plain static hosting without extensionless rewrites.Adds a Page URLs in static bundles section (with anchor
page-urls-in-static-bundlesin localized pages) to the English, Spanish, French, and Chineseapi/static-export/overviewpages. The new copy explains that the Static Export API turns this on automatically, contrasts CloudFront (client nav/prefetch preserved) with file-only hosts (full-page.htmllinks), and notes that canonical/sitemap and optional client nav URLs can stay extensionless—with a caveat that file-only hosts may need rewrites.The Chinese overview also extends the frontmatter description with S3/CDN/static hosting context.
The localized overviews now also explain that built-in internal navigation uses
.htmldestinations and preserves query strings.Reviewed by Cursor Bugbot for commit ac1abc1. Bugbot is set up for automated code reviews on this repo. Configure here.
Update history
Note
Low Risk
Documentation-only updates to static export overview MDX; no application or API code changes.
Overview
Adds a Page URLs in static bundles section to the static export overview in English, Spanish, French, and Chinese, describing how exported pages use explicit
.htmlpaths (e.g./guides/getting-started.html,/index.htmlin localized copy) so bundles align with files on S3 or plain static hosts.The new text states the Static Export API enables this without doc config changes, contrasts CloudFront (client navigation/prefetch) with file-only hosting (full-page
.htmllinks), and notes that canonical and sitemap URLs stay extensionless—with a warning that non-CloudFront hosts may need rewrites. Localized pages also document built-in internal navigation (switchers, search, cards, assistant, API playground) using.htmltargets while preserving query strings. The Chinese overview extends frontmatterdescriptionwith S3/CDN hosting context.Reviewed by Cursor Bugbot for commit 018a278. Bugbot is set up for automated code reviews on this repo. Configure here.